home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Belgian Amiga Club - ADF Collection
/
BS1 part 23.zip
/
BS1 part 23
/
Bootstart.adf
/
HunkX
/
HunkX1.20.doc
< prev
next >
Wrap
Text File
|
1991-04-09
|
4KB
|
134 lines
HunkX 1.20 User Manual
January 23, 1991
Requires the arp.library
DISCLAIMER
HunkX has been thoroughly tested and is the result of a constant process of
changes and updates. The program has proven to be stable in everyday use.
The author is not responsible for any loss of data, damages to software or
hardware that may result directly or indirectly from the use of this
program.
If you have suggestions or remarks about this program, of if you find any
bugs, please let me know.
Write to the following address:
Peter Stuer
Kauwlei 21
B-2550 Kontich
Belgium - Europe
This documentation will always be updated at the top. Users of previous
versions of HunkX need only to read the paragraph reflecting the changes
since their last version.
Introduction
------------
HunkX is a small program written completely in Assembler to show
the hunk structure of any segment-loadable file. It has been tested on
normal Amiga executables, object files, libraries, Lattice C linker
libraries, all with or without debuging or symbol information. Note that
Aztec C linker libraries are not supported since they are non-standard.
Most of the new hunks in KickStart 2.0 are also supported. Refer to the
features section.
Non-programmers won't have a lot of use for HunkX. It display technical
information that can be useful for programmers only.
Usage
-----
HunkX is for CLI usage only. Trying to run HunkX from the Workbench may
result in a system crash.
Run HunkX without any arguments to get the usage template:
1>
HunkX v1.20
: by Peter Stuer - January 23, 1991 FREEWARE
Examines the hunk structure of a file.
Usage: HunkX [-v] <filename> [...]
-v Verbose
The verbose switch show a lot more information f.e. all the debuging
symbols together with there offsets/values
For example:
1> HunkX preferences
shows the hunk structure of the Preferences program.
HunkX supports the Arp wild-cards.
1> HunkX -v LIBS:*.library
will show the hunk structure of all the files in your LIBS: directory with
the ending '.library' using the verbose mode.
The output of HunkX can be interrupted by control-C or control-D.
Control-C stops the output of current file. Control-D stops HunkX
completely in case you have specified a number of files, either direct or
by using wild-cards.
Features
--------
- Supported hunk types:
HUNK_UNIT 999
HUNK_NAME 1000
HUNK_CODE 1001
HUNK_DATA 1002
HUNK_BSS 1003
HUNK_RELOC32 1004
HUNK_RELOC16 1005 Not supported yet
HUNK_RELOC8 1006 Not supported yet
HUNK_EXT 1007
HUNK_SYMBOL 1008
HUNK_DEBUG 1009
HUNK_END 1010
HUNK_HEADER 1011
HUNK_OVERLAY 1013
HUNK_BREAK 1014
HUNK_DREL32 1015 Not supported yet
HUNK_DREL16 1016
HUNK_DREL8 1017 Not supported yet
HUNK_LIB 1018
HUNK_INDEX 1019
Error messages
--------------
"Unknown hunk: $xxxxxxxx"
HunkX encountered a hunk of which the structure is not known. $xxxxxxxx is
the identification number of the erroneous hunk. Most likely you tried to
view the hunk structure of a file that has no hunk f.e. a ASCII document
or an icon file.
"DOS error n".
While trying to load the file, AmigaDOS reported an error. Please refer to
a AmigaDOS reference manual for the exact meaning of the error number.
Future enhancements
-------------------
- New hunks in KickStart x.x
© 1991 Peter Stuer
_
_ //
Thanks to \X/ Amiga for being the best computer ever !